home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 22 / AACD 22.iso / CDTools / Players / DeliTracker / Docs / Genies.eng < prev    next >
Text File  |  2000-03-30  |  32KB  |  548 lines

  1.  
  2.  
  3.                     $VER: Genies.eng V2.32 (20.03.2000)
  4.                    Copyright 2000 by Delirium Softdesign
  5.                       (Peter Kunath and Frank Riffel)
  6.  
  7.  
  8.  
  9.   In this document file are all genies listed that are offically released
  10.   or supported by Delirium Softdesign. A description of the standard menus
  11.   of the GUI is omitted. Only genie specific GUI elements are described
  12.   herein.
  13.  
  14.   +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  15.   WANTED: Developer docs for WaveTools/PeriSound, SoundStage and AD516. The
  16.   first person which sends us the programming docs for one of these cards
  17.   will get a free DeliTracker registration (and maybe a NotePlayer as well
  18.   if the documentation is detailed enough).
  19.   +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  20.  
  21.  
  22.   1. NOTEPLAYER GENIES
  23.  
  24.   Noteplayers that use MEMF_PUBLIC or MEMF_ANY require only a small chipmem
  25.   buffer for playing the samples. This enables you to load modules that are
  26.   even bigger than your actual chipmem. On the other hand this will cost
  27.   you some extra cpu cycles.
  28.  
  29.   Name                          Description
  30.   ==========================    ===========================================
  31.  
  32.   AudioDev-NotePlayer           --- Removed ---
  33.                                 We removed this noteplayer because there
  34.                                 are bugs in the audio.device which cause
  35.                                 many problems. There are no workarounds
  36.                                 for these bugs.
  37.  
  38.   Paula-NotePlayer              Up to 4 Voices. Uses MEMF_CHIP to hold the
  39.                                 samples. Uses the audio.device channel
  40.                                 allocation but plays the 'notes' by writing
  41.                                 directly to the current paula chip.
  42.                                 GUI: Selection of the allocation precedence
  43.                                 of the channels.
  44.                                 Note: Some programs incorrectly using the
  45.                                 audio.device will have problems. Term 3.4
  46.                                 is one of them. You can avoid the problems
  47.                                 if you select 127 as allocation precedence.
  48.                                 But then one of the advantages of this
  49.                                 Noteplayer is gone away.
  50.  
  51.   4Voices-NotePlayer            Up to 4 Voices. Uses MEMF_ANY to hold the
  52.                                 samples. Only a 1KB chipmem buffer is used.
  53.                                 GUI: Each channel can be enabled/disabled.
  54.                                 Note: On A3000 this NotePlayer eats about
  55.                                 4% more cpu-cycles than Paula-NotePlayer.
  56.  
  57.   8Voices-NotePlayer            Up to 8 Voices. Uses MEMF_ANY to hold the
  58.                                 samples. Thanks to Jörg Schmidt. The mixing
  59.                                 routine is © 1991 by Maxon Computer GmbH.
  60.                                 GUI: Each channel can be enabled/disabled.
  61.  
  62.   32Voices-NotePlayer           Up to 32 Voices. Uses MEMF_ANY to hold the
  63.                                 samples. Uses DeliMix.
  64.                                 GUI: Left and Right stereo channel can be
  65.                                 enabled or disabled. The Mixfrequency can
  66.                                 be set between 4 kHz and 60 kHz.
  67.  
  68.   32Voices-NotePlayerPlus       Up to 32 Voices. Uses MEMF_ANY to hold the
  69.                                 samples. Uses DeliMix.
  70.                                 GUI: Left and Right stereo channel can be
  71.                                 enabled or disabled. Additionally there is
  72.                                 a volume boost slider. If Auto-Boost is
  73.                                 enabled the boost is preset. This value
  74.                                 depends on the requested number of channels.
  75.                                 There are some trade off's with this
  76.                                 NotePlayer: It requires quite a lot of
  77.                                 CPU power. The Mixfrequency can be set
  78.                                 between 4 kHz and 60 kHz.
  79.  
  80.   14Bit-NotePlayer              Up to 32 Voices. Uses MEMF_ANY to hold the
  81.                                 samples. Uses DeliMix. The mixing result
  82.                                 will be output with 14Bit quality. Due to
  83.                                 used output scheme the output level might
  84.                                 be low. You can raise the level with the
  85.                                 boost-slider, but we recommend to use the
  86.                                 volume control of your amplifier instead.
  87.                                 If existent this genies uses the CyberSound
  88.                                 calibration-prefs for optimum quality.
  89.                                 GUI: Left and Right stereo channel can be
  90.                                 enabled or disabled. The new version has an
  91.                                 additional volume boost slider. If Auto-Boost
  92.                                 is enabled the boost is preset. This value
  93.                                 depends on the requested number of channels.
  94.                                 As usual the Mixfrequency can be set between
  95.                                 4 kHz and 60 kHz.
  96.  
  97.   AHI-NotePlayer                This NotePlayer is based on the AHI audio
  98.                                 system from Martin Blom.
  99.                                 For more information refer to:
  100.                                 http://www.lysator.liu.se/~lcs/ahi.html
  101.  
  102.   Headphone-NotePlayer          Up to 32 Voices. Uses MEMF_ANY to hold the
  103.                                 samples. Uses DeliMix. This Noteplayer is
  104.                                 intended for use with headphones.
  105.                                 GUI: Left and Right stereo channel can be
  106.                                 enabled or disabled. With a slider you can
  107.                                 control the stereo factor: 0% = mono,
  108.                                 100% = full stereo, 50% = each channel is
  109.                                 mixed with 50% level on the opposite side.
  110.                                 Additionally there is a volume boost slider.
  111.                                 If Auto-Boost is enabled the boost is preset.
  112.                                 This value depends on the requested number
  113.                                 of channels. The Mixfrequency can be set
  114.                                 between 4 kHz and 60 kHz.
  115.  
  116.   ModSave-NotePlayer            Up to 16 Voices. Uses MEMF_ANY to hold the
  117.                                 samples. Uses DeliMix. With this noteplayer
  118.                                 you can transform your favorite modules
  119.                                 into samples :-)
  120.                                 GUI: Left and Right stereo channel can be
  121.                                 enabled or disabled. The Mixfrequency can
  122.                                 be set between 4 kHz and 60 kHz. If the
  123.                                 'Save Sample' gadget is checked an IFF-8SVX
  124.                                 sample will be written to the file you have
  125.                                 specified in the 'Filename' gadget. If no
  126.                                 filename is given, a file requester will pop
  127.                                 up and ask you. With the 'Mode' Cyclegadget
  128.                                 you can select whether a Mono or a Stereo
  129.                                 sample should be created. In Mono mode up to
  130.                                 eight channels are saved. In Stereo Mode, up
  131.                                 to sixteen channels are saved.
  132.                                 Additionally there is a volume boost slider.
  133.                                 If Auto-Boost is enabled the boost is preset.
  134.                                 This value depends on the requested number
  135.                                 of channels. The Mixfrequency can be set
  136.                                 between 4 kHz and 60 kHz.
  137.  
  138.   Toccata-NotePlayer            Up to 32 Voices, supports Panning. Uses
  139.                                 MEMF_ANY to hold the samples. This NotePlayer
  140.                                 will use the Toccata soundboard to produce
  141.                                 true 16bit sound.
  142.                                 Note: DraCo users require at least V12 of the
  143.                                 toccata.library.
  144.                                 Available for registered users upon request.
  145.  
  146.   MPro-NotePlayer               Up to 32 Voices, supports Panning. Uses
  147.                                 MEMF_ANY to hold the samples. This NotePlayer
  148.                                 will use the Maestro Professional card to
  149.                                 produce true 16bit sound.
  150.                                 Available for registered users upon request.
  151.  
  152.  
  153.   2.DECRUNCH GENIES
  154.  
  155.   Name                          Description
  156.   ==========================    ===========================================
  157.  
  158.   Decruncher                    This genie can decrunch 'imploded' files
  159.                                 and LhA, GZip, Zip and Lzx archives. Only the
  160.                                 first file from an archive will be decrunched.
  161.                                 Files that match the exclude pattern will be
  162.                                 skipped.
  163.  
  164.  
  165.   3.CONVERT GENIES
  166.  
  167.   Name                          Description
  168.   ==========================    ===========================================
  169.  
  170.   Deli-Wizard                   Copyright © 1994-95 by Nicolas FRANCK.
  171.                                 Reconverts the most Protracker 'Packers'
  172.                                 back to ProTracker. Currently, -51- formats
  173.                                 are recognized and converted:
  174.  
  175.                                       Noise/Protracker
  176.                                       Heatseeker Packer
  177.                                       Xann-Packer
  178.                                       Pha-Packer
  179.                                       NoisePacker_v1/2
  180.                                       NoisePacker_v3
  181.                                       Promizer_v1.0c
  182.                                       Promizer_v1.8a
  183.                                       Promizer_v2.0
  184.                                       Wanton-Packer
  185.                                       SKYT-Packer
  186.                                       ProPacker_v1.0
  187.                                       ProPacker_v2.1
  188.                                       ProPacker_v3.0
  189.                                       ProRunner_v1.0
  190.                                       Laxity-Tracker
  191.                                       UNIC-Tracker
  192.                                       KRIS-Tracker
  193.                                       ProRunner_v2.0
  194.                                       NoiseRunner
  195.                                       EUREKA-Packer
  196.                                       AC1D-Packer
  197.                                       Pygmy Projects
  198.                                       Digital Illusions
  199.                                       Channel Player v1
  200.                                       Channel Player v2
  201.                                       Channel Player v3
  202.                                       Promizer_v4.0
  203.                                       The Player v5.0a
  204.                                       StarTrekker Pack'
  205.                                       The Player v6.0a
  206.                                       GMC
  207.                                       Module Protector
  208.                                       Promizer v0.1
  209.                                       Soundtracker 2.6
  210.                                       FC-M Packer
  211.                                       IceTracker
  212.                                       Fuzzac Packer
  213.                                       Kefrens Sound Machine
  214.                                       The Player 40A/40B/41A
  215.                                       Tracker Packer 1/2/3
  216.                                       NoiseTracker Pak
  217.                                       Polka Packer
  218.                                       Power Music
  219.                                       Soundtracker Pro 3.0
  220.                                       Zen Packer
  221.                                       The Player v6.1a
  222.                                       Hornet Packer
  223.  
  224.                                 GUI: Enable/Disable conversion routines.
  225.                                 Modules can be saved with the 'Save Module'
  226.                                 button. This will bring up a file requester.
  227.  
  228.                                 Note: To become a registered user of both
  229.                                       Pro-Wizard-2 and Deli-Wizard, send
  230.  
  231.                                           50 FF  /  15$ US  /  20 DM
  232.  
  233.                                 to:   Nicolas FRANCK
  234.                                       157, Rue de Strasbourg
  235.                                       77350 Le Mée sur Seine
  236.                                       France
  237.  
  238.                                 You can send bugreports and suggestions
  239.                                 concerning Deli-Wizard or Pro-Wizard to
  240.                                 this address as well.
  241.  
  242.   Converter                     This genie converts 'exotic' modules into
  243.                                 more common formats that can be played with
  244.                                 DeliTracker. Currently these formats are
  245.                                 recognized and converted:
  246.  
  247.                                      In Stereo! => Synthesis 
  248.                                      GraveComposer => FastTracker
  249.                                      Octalyzer => FastTracker
  250.                                       (this format is not the
  251.                                        same as Oktalyzer!)
  252.                                      MED Song => MED Module
  253.                                      StarTrekker8 => TakeTracker
  254.                                      FutureComposer 1.3 => FutureComposer 1.4
  255.                                      SoundTracker => SoundTracker15
  256.                                      DigitalTracker 1.0 => TakeTracker
  257.  
  258.                                 GUI: Enable/Disable conversion routines.
  259.  
  260.   ST-NT-PT-Song_Converter       The genie converts Sound/Noise/ProTracker
  261.                                 Songs into modules. The song and all samples
  262.                                 may be packed. The samples may be either
  263.                                 located in the volume that the song tells
  264.                                 (e.g. ST-01:) or in an equal named subdirectory
  265.                                 (e.g. ST-01/). The path of this subdir can be
  266.                                 set with the GUI. If a sample is not found
  267.                                 the user is asked for a replacement.
  268.                                 GUI: Sets the instrument search path.
  269.  
  270.  
  271.   4.OTHER GENIES
  272.  
  273.   Name                          Description
  274.   ==========================    ===========================================
  275.  
  276.   ModuleInfo                    This genie will show some information about
  277.                                 the current module. At the moment the real
  278.                                 module name, file size, number of patterns,
  279.                                 estimated duration, sample names and length
  280.                                 may be displayed
  281.                                 GUI: 'Settings'-Menu: Duration will enable
  282.                                 the calculation of the estimated playtime.
  283.  
  284.   MonoScope                     This genie displays current waveform in a
  285.                                 neat new way. This genie works with up to 8
  286.                                 Voices. Each pixel represents a point in
  287.                                 time. The x and y co-ordinates of it are
  288.                                 correlated to the sample. In 'Single Mode'
  289.                                 the x position is taken from the amplitude
  290.                                 of the left channel. The y position is
  291.                                 taken from the amplitude of the right
  292.                                 channel. This is how the left channel
  293.                                 correlates to the right. The x co-ordinate
  294.                                 of an point in 'Double Mode' is taken from
  295.                                 the amplitude of the signal. The y
  296.                                 co-ordinate is taken from the amplitude
  297.                                 a fixed short time interval later. This
  298.                                 mode shows how the signal correlates to
  299.                                 itself.
  300.                                 GUI:    Settings
  301.                                         :
  302.                                         Nasty Blit
  303.                                                 This is to fix some problems
  304.                                                 with (EGS) GfX cards. These
  305.                                                 arise from blit operations
  306.                                                 done by the cpu. If enabled
  307.                                                 Forbid()/Permit() is used to
  308.                                                 to protect those operations.
  309.                                         ~~~~~~~~~~~~~~~
  310.                                         Single Mode A-I Select single mode
  311.                                         Double Mode A-O Select double mode
  312.  
  313.   StereoScope                   This genie displays current waveform as
  314.                                 stereo signal. If you would connect an
  315.                                 oscilloscope at the audio jacks and select
  316.                                 a frequency range of about 2 kHz you should
  317.                                 see the same signals. This genie works with
  318.                                 up to 8 Voices.
  319.                                 GUI:    Settings
  320.                                         :
  321.                                         Nasty Blit
  322.                                                 This is to fix some problems
  323.                                                 with (EGS) GfX cards. These
  324.                                                 arise from blit operations
  325.                                                 done by the cpu. If enabled
  326.                                                 Forbid()/Permit() is used to
  327.                                                 to protect those operations.
  328.  
  329.   QuadraScope                  This genie displays current waveform of up
  330.                                 to 4 channels - not sizeable, moderate cpu
  331.                                 load.
  332.                                 GUI:    Settings
  333.                                         :
  334.                                         Nasty Blit
  335.                                                 This is to fix some problems
  336.                                                 with (EGS) GfX cards. These
  337.                                                 arise from blit operations
  338.                                                 done by the cpu. If enabled
  339.                                                 Forbid()/Permit() is used to
  340.                                                 to protect those operations.
  341.  
  342.  
  343.  
  344.   QuadraScopePlus               Copyright 1994-95 by Florian Vorberger.
  345.                                 This genie displays the waveforms of up to
  346.                                 4 channels. QuadraScope+ updates 50 times a
  347.                                 second. This means it needs quite a lot of
  348.                                 CPU cycles. The CPU power increase is approx.
  349.                                 linear to the windows size. If you experience
  350.                                 a slow display you might need to shrink your
  351.                                 window. If you use a 'Solid' display the
  352.                                 required CPU power depends more on the window
  353.                                 height.
  354.                                 GUI:    Settings
  355.                                         :
  356.                                         Nasty Blit
  357.                                                 This is to fix some problems
  358.                                                 with (EGS) GfX cards. These
  359.                                                 arise from blit operations
  360.                                                 done by the cpu. If enabled
  361.                                                 Forbid()/Permit() is used to
  362.                                                 to protect those operations.
  363.                                         ~~~~~~~~~~
  364.                                         Half   A-A Displays the absolute
  365.                                                    level from zero to top.
  366.                                                    Treat samples unsigned.
  367.                                         Mirror A-M Same as half except the
  368.                                                    zero line is centered and
  369.                                                    the level is also drawn in
  370.                                                    the negative range.
  371.                                                 Note: If 'Half' and 'Mirror'
  372.                                                    are off the sample is
  373.                                                    treated as signed. This
  374.                                                    is the default mode.
  375.                                         ~~~~~~~~~~
  376.                                         Dot    A-D Draw only sample values
  377.                                         Line   A-L Connect sample values
  378.                                                    with lines.
  379.                                         Solid  A-O Filled display
  380.  
  381.                                 QuadraScope+ written by Florian Vorberger.
  382.                                 It may only be distributed along with the
  383.                                 DeliTracker_II package! You are allowed to
  384.                                 use QuadraScope+ only for NON-Commercial
  385.                                 purposes. If you find any bugs, have any
  386.                                 ideas for improving 'Quadrascope+' or want
  387.                                 a special commercial-usage agreement please
  388.                                 contact:
  389.                                  Florian.Vorberger@informatik.tu-muenchen.de
  390.                                  or Delirium Softdesign (we will forward any
  391.                                  wishes).
  392.  
  393.   LightOrgan_Color              This genie displays the summed volume level
  394.                                 (amplitude) of up to 8 channels. The sum of
  395.                                 the left channels control the blue level
  396.                                 and the right channels control the red
  397.                                 level. This genie allocates one pen and
  398.                                 therefore requires at least V39.
  399.                                 Note: If you want to run this genie on
  400.                                 your Workbench Screen you must choose
  401.                                 a screen mode with at least 16 colors!
  402.  
  403.   FFTAnalyzer                   This genie displays the frequency spectrum of
  404.                                 up to 4 left and right channels. The display
  405.                                 is divided into two columns (one for the left
  406.                                 and one for the right channels). Each column
  407.                                 consists of 64 equally spaced bars. A single
  408.                                 bar represents a frequency range of 110Hz.
  409.                                 The topmost bar represents the highest
  410.                                 frequency range (ie. 7.5kHz). The displayed
  411.                                 amplitude of a frequency range is proportional
  412.                                 to the sound pressure level in dB(A). Refer
  413.                                 to DIN IEC-651 for more information. The
  414.                                 frequency spectrum is calculated using a highly
  415.                                 optimized 504-Point-Fast-Fourier-Transform.
  416.                                 Big thanks to Kim Øyhus for providing the new
  417.                                 FFT routine!
  418.                                 GUI:    Settings
  419.                                         :
  420.                                         Nasty Blit
  421.                                                 This is to fix some problems
  422.                                                 with (EGS) GfX cards. These
  423.                                                 arise from blit operations
  424.                                                 done by the cpu. If enabled
  425.                                                 Forbid()/Permit() is used to
  426.                                                 to protect those operations.
  427.  
  428.   FFTScope                      This genie displays the change of the frequency
  429.                                 spectrum over time. It supports up to four
  430.                                 left and right channels. The lightness of the 
  431.                                 pixels corresponds to the value of the frequency
  432.                                 component (ie. lighter color indicates higher
  433.                                 intensity). The frequency axis starts at the
  434.                                 window bottom (low frequencies).
  435.                                 GUI:    Settings
  436.                                         :
  437.                                         Nasty Blit
  438.                                                 This is to fix some problems
  439.                                                 with (EGS) GfX cards. These
  440.                                                 arise from blit operations
  441.                                                 done by the cpu. If enabled
  442.                                                 Forbid()/Permit() is used to
  443.                                                 to protect those operations.
  444.                                         ~~~~~~~~~~
  445.                                         Frequency Range
  446.                                                 Allows you to select the
  447.                                                 frequency range which will be
  448.                                                 displayed (6 - 8 octaves).
  449.  
  450.   DrWhoGenie                    This genie is based on the rotating tunnel
  451.                                 effect from Sanity's demo 'ARTE'. Many thanks
  452.                                 to Chaos/Sanity for his routines!
  453.                                 This genie needs OS 3.0 and a screen with at
  454.                                 least 16 free pens.
  455.                                 GUI:    Settings
  456.                                         :
  457.                                         Nasty Blit
  458.                                                 This is to fix some problems
  459.                                                 with (EGS) GfX cards. These
  460.                                                 arise from blit operations
  461.                                                 done by the cpu. If enabled
  462.                                                 Forbid()/Permit() is used to
  463.                                                 to protect those operations.
  464.                                         ~~~~~~~~~~
  465.                                         Own C2P A-2 A highly optimized C2P
  466.                                                     conversion routine in
  467.                                                     conjunction with
  468.                                                     BltBitMapRastPort() is
  469.                                                     used to draw the picture.
  470.                                         Use WPA A-W Uses the V39 OS function
  471.                                                     WritePixelArray8() to
  472.                                                     draw the picture.
  473.                                         Use WCP A-C Uses the V40 OS function
  474.                                                     WriteChunkyPixels() to
  475.                                                     draw the picture.
  476.                                         Note: Please check which option is
  477.                                               the fastest on your system!
  478.                                         ~~~~~~~~~~
  479.                                         16 Colors A-1 Uses 16 colors for the
  480.                                                       tunnel.
  481.                                         64 Colors A-6 Uses 64 colors for the
  482.                                                       tunnel. If 64 colors are
  483.                                                       not available it tries
  484.                                                       to allocate fewer colors.
  485.                                                       But at least 16 colors
  486.                                                       must be available or
  487.                                                       the genie won't run.
  488.  
  489.   LevelMeter                    This genie displays the sound pressure level
  490.                                 of up to 16 different channel.
  491.                                 The CPU-usage is moderate.
  492.                                 GUI: Settings
  493.                                      :
  494.                                      ~~~~~~~~~~
  495.                                      Height
  496.                                         »Half Halves the window height.
  497.                                         »Full Switches to full height.
  498.  
  499.                                      Width
  500.                                         »Variable The horizontal size is
  501.                                                      dynamically adjusted
  502.                                                      each time the number of
  503.                                                      active channels changes.
  504.                                         »4 Channels Displays a fixed number
  505.                                          .          of channels depending on
  506.                                          .          the selected menu item.
  507.                                         »16 Channels
  508.  
  509.   NewYear-Genie                 Some New Year fun on your monitor.
  510.                                 This genie needs at least Kick 3.0 (OS V39)
  511.                                 and a screen with at least 16 free pens. A gfx
  512.                                 card is not required, but recommended for
  513.                                 optimum speed. A fast processor will also make
  514.                                 the genie look much better.
  515.  
  516.   Xmas-Genie                    White Christmas on your monitor, sparkling
  517.                                 in your eye :-)
  518.                                 Controls: Volume Slider: SNOW RATE
  519.                                           Balance Slider: WIND DIRECTION
  520.                                           Play/Pause: Heaven's SNOW SWITCH:-)
  521.                                           Eject: Melt Snow
  522.                                 The genie will melt all snow if over 50% of
  523.                                 the topmost line contains 'snow'.
  524.  
  525.  
  526.   5. DELIMIX
  527.  
  528.   DeliMix is © 1994-2000 by Delirium Softdesign. DeliMix is real time sample
  529.   mixing technology. It is the base of many Noteplayers that have virtual
  530.   channels. With this mixing technology it is possible to mix samples with
  531.   different sample rates into one output sample. The output sample is
  532.   generated at a given mixfrequency (rate). Choosing a higher output rate
  533.   will yield better results at the expense of more cpu power. DeliMix takes
  534.   advance of an existing 020 or higher. An optimized routine will be used
  535.   in this case. This routine is about 20% faster. There is a critical point
  536.   at ~30 kHz mixing frequency. Selecting a higher mixing frequency will
  537.   make only sense if you run productivity. This is because in the current
  538.   amiga hardware, the audio DMA is coupled with the scan rate. The hardware
  539.   can output two samples per scanline. In standard video mode, this results
  540.   in a maximum output rate of ~30 kHz. Because in productivity the scanrate
  541.   doubles an output rate of ~60 kHz is possible. All NotePlayers will step
  542.   down the mixing rate if the cpu is not fast enough to provide the desired
  543.   mixing frequency! - This is to protect the system from hanging in the
  544.   interrupt (mixing loop).
  545.  
  546.  
  547.  
  548.